

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
  <meta charset="utf-8">
  
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta name="Description" content="scikit-learn: machine learning in Python">

  
  <title>Welcome to scikit-learn &mdash; scikit-learn 0.22 documentation</title>
  
  <link rel="canonical" href="http://scikit-learn.org/stable/preface.html" />

  
  <link rel="shortcut icon" href="_static/favicon.ico"/>
  

  <link rel="stylesheet" href="_static/css/vendor/bootstrap.min.css" type="text/css" />
  <link rel="stylesheet" href="_static/gallery.css" type="text/css" />
  <link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<script id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script> 
</head>
<body>
<nav id="navbar" class="sk-docs-navbar navbar navbar-expand-md navbar-light bg-light py-0">
  <div class="container-fluid sk-docs-container px-0">
      <a class="navbar-brand py-0" href="index.html">
        <img
          class="sk-brand-img"
          src="_static/scikit-learn-logo-small.png"
          alt="logo"/>
      </a>
    <button
      id="sk-navbar-toggler"
      class="navbar-toggler"
      type="button"
      data-toggle="collapse"
      data-target="#navbarSupportedContent"
      aria-controls="navbarSupportedContent"
      aria-expanded="false"
      aria-label="Toggle navigation"
    >
      <span class="navbar-toggler-icon"></span>
    </button>

    <div class="sk-navbar-collapse collapse navbar-collapse" id="navbarSupportedContent">
      <ul class="navbar-nav mr-auto">
        <li class="nav-item">
          <a class="sk-nav-link nav-link" href="install.html">Install</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link" href="user_guide.html">User Guide</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link" href="modules/classes.html">API</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link" href="auto_examples/index.html">Examples</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="getting_started.html">Getting Started</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="tutorial/index.html">Tutorial</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="glossary.html">Glossary</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="developers/index.html">Development</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="faq.html">FAQ</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="related_projects.html">Related packages</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="roadmap.html">Roadmap</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="about.html">About us</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="https://github.com/scikit-learn/scikit-learn">GitHub</a>
        </li>
        <li class="nav-item">
          <a class="sk-nav-link nav-link nav-more-item-mobile-items" href="https://scikit-learn.org/dev/versions.html">Other Versions</a>
        </li>
        <li class="nav-item dropdown nav-more-item-dropdown">
          <a class="sk-nav-link nav-link dropdown-toggle" href="#" id="navbarDropdown" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">More</a>
          <div class="dropdown-menu" aria-labelledby="navbarDropdown">
              <a class="sk-nav-dropdown-item dropdown-item" href="getting_started.html">Getting Started</a>
              <a class="sk-nav-dropdown-item dropdown-item" href="tutorial/index.html">Tutorial</a>
              <a class="sk-nav-dropdown-item dropdown-item" href="glossary.html">Glossary</a>
              <a class="sk-nav-dropdown-item dropdown-item" href="developers/index.html">Development</a>
              <a class="sk-nav-dropdown-item dropdown-item" href="faq.html">FAQ</a>
              <a class="sk-nav-dropdown-item dropdown-item" href="related_projects.html">Related packages</a>
              <a class="sk-nav-dropdown-item dropdown-item" href="roadmap.html">Roadmap</a>
              <a class="sk-nav-dropdown-item dropdown-item" href="about.html">About us</a>
              <a class="sk-nav-dropdown-item dropdown-item" href="https://github.com/scikit-learn/scikit-learn">GitHub</a>
              <a class="sk-nav-dropdown-item dropdown-item" href="https://scikit-learn.org/dev/versions.html">Other Versions</a>
          </div>
        </li>
      </ul>
      <div id="searchbox" role="search">
          <div class="searchformwrapper">
          <form class="search" action="search.html" method="get">
            <input class="sk-search-text-input" type="text" name="q" aria-labelledby="searchlabel" />
            <input class="sk-search-text-btn" type="submit" value="Go" />
          </form>
          </div>
      </div>
    </div>
  </div>
</nav>
<div class="d-flex" id="sk-doc-wrapper">
    <input type="checkbox" name="sk-toggle-checkbox" id="sk-toggle-checkbox">
    <label id="sk-sidemenu-toggle" class="sk-btn-toggle-toc btn sk-btn-primary" for="sk-toggle-checkbox">Toggle Menu</label>
    <div id="sk-sidebar-wrapper" class="border-right">
      <div class="sk-sidebar-toc-wrapper">
        <div class="sk-sidebar-toc-logo">
          <a href="index.html">
            <img
              class="sk-brand-img"
              src="_static/scikit-learn-logo-small.png"
              alt="logo"/>
          </a>
        </div>
        <div class="btn-group w-100 mb-2" role="group" aria-label="rellinks">
            <a href="contents.html" role="button" class="btn sk-btn-rellink py-1" sk-rellink-tooltip="Table Of Contents">Prev</a>
            <a href="#" role="button" class="btn sk-btn-rellink disabled py-1">Up</a>
            <a href="install.html" role="button" class="btn sk-btn-rellink py-1" sk-rellink-tooltip="Installing scikit-learn">Next</a>
        </div>
        <div class="alert alert-danger p-1 mb-2" role="alert">
          <p class="text-center mb-0">
          <strong>scikit-learn 0.22</strong><br/>
          <a href="http://scikit-learn.org/dev/versions.html">Other versions</a>
          </p>
        </div>
        <div class="alert alert-warning p-1 mb-2" role="alert">
          <p class="text-center mb-0">
            Please <a class="font-weight-bold" href="about.html#citing-scikit-learn"><string>cite us</string></a> if you use the software.
          </p>
        </div>
          <div class="sk-sidebar-toc sk-sidebar-global-toc">
            <ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">Welcome to scikit-learn</a><ul>
<li class="toctree-l2"><a class="reference internal" href="install.html">Installing scikit-learn</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html">Frequently Asked Questions</a></li>
<li class="toctree-l2"><a class="reference internal" href="support.html">Support</a></li>
<li class="toctree-l2"><a class="reference internal" href="related_projects.html">Related Projects</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html">About us</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html">Who is using scikit-learn?</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new.html">Release History</a></li>
<li class="toctree-l2"><a class="reference internal" href="roadmap.html">Roadmap</a></li>
<li class="toctree-l2"><a class="reference internal" href="governance.html">Scikit-learn governance and decision-making</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="tutorial/index.html">scikit-learn Tutorials</a></li>
<li class="toctree-l1"><a class="reference internal" href="getting_started.html">Getting Started</a></li>
<li class="toctree-l1"><a class="reference internal" href="user_guide.html">User Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="glossary.html">Glossary of Common Terms and API Elements</a></li>
<li class="toctree-l1"><a class="reference internal" href="auto_examples/index.html">Examples</a></li>
<li class="toctree-l1"><a class="reference internal" href="modules/classes.html">API Reference</a></li>
<li class="toctree-l1"><a class="reference internal" href="developers/index.html">Developer’s Guide</a></li>
</ul>

          </div>
      </div>
    </div>
    <div id="sk-page-content-wrapper">
      <div class="sk-page-content container-fluid body px-md-3" role="main">
        
  <span class="target" id="preface-menu"></span><style type="text/css">
  div.body div.toctree-wrapper ul {
      padding-left: 0;
  }

  div.body li.toctree-l1 {
      padding: 0 0 0.5em 0;
      list-style-type: none;
      font-size: 150%;
      font-weight: bold;
  }

  div.body li.toctree-l2 {
      font-size: 70%;
      list-style-type: square;
      font-weight: normal;
      margin-left: 40px;
  }

  div.body li.toctree-l3 {
      font-size: 85%;
      list-style-type: circle;
      font-weight: normal;
      margin-left: 40px;
  }

  div.body li.toctree-l4 {
      margin-left: 40px;
  }

</style> <script>
 window.addEventListener('DOMContentLoaded', function() {
      (function($) {
 //Function to make the index toctree collapsible
 $(function () {
     $('div.body .toctree-l2')
         .click(function(event){
             if (event.target.tagName.toLowerCase() != "a") {
                 if ($(this).children('ul').length > 0) {
                      $(this).attr('data-content',
                          (!$(this).children('ul').is(':hidden')) ? '\u25ba' : '\u25bc');
                     $(this).children('ul').toggle();
                 }
                 return true; //Makes links clickable
             }
         })
         .mousedown(function(event){ return false; }) //Firefox highlighting fix
         .children('ul').hide();
     // Initialize the values
     $('div.body li.toctree-l2:not(:has(ul))').attr('data-content', '-');
     $('div.body li.toctree-l2:has(ul)').attr('data-content', '\u25ba');
     $('div.body li.toctree-l2:has(ul)').css('cursor', 'pointer');

     $('div.body .toctree-l2').hover(
         function () {
             if ($(this).children('ul').length > 0) {
                 $(this).css('background-color', '#e5e5e5').children('ul').css('background-color', '#F0F0F0');
                 $(this).attr('data-content',
                     (!$(this).children('ul').is(':hidden')) ? '\u25bc' : '\u25ba');
             }
             else {
                 $(this).css('background-color', '#F9F9F9');
             }
         },
         function () {
             $(this).css('background-color', 'white').children('ul').css('background-color', 'white');
             if ($(this).children('ul').length > 0) {
                 $(this).attr('data-content',
                     (!$(this).children('ul').is(':hidden')) ? '\u25bc' : '\u25ba');
             }
         }
     );
 });
      })(jQuery);
  });
 </script>

<style type="text/css">
  div.body li, div.body ul {
      transition-duration: 0.2s;
  }

  div.body li.toctree-l1 {
      padding: 5px 0 0;
      list-style-type: none;
      font-size: 150%;
      background-color: #f2f2f2;
      font-weight: normal;
      color: #20435c;
      margin-left: 0;
      margin-bottom: 1.2em;
      font-weight: bold;
      }

  div.body li.toctree-l1 a {
      color: #314F64;
  }

  div.body li.toctree-l1 > a {
      margin-left: 0.75rem;
  }

  div.body li.toctree-l2 {
      padding: 0.25em 0 0.25em 0 ;
      list-style-type: none;
      background-color: #FFFFFF;
      font-size: 85% ;
      font-weight: normal;
      margin-left: 0;
  }

  div.body li.toctree-l2 ul {
      padding-left: 40px ;
  }

  div.body li.toctree-l2:before {
      content: attr(data-content);
      font-size: 1rem;
      color: #777;
      display: inline-block;
      width: 1.5rem;
  }

  div.body li.toctree-l3 {
      font-size: 88% ;
      list-style-type: square;
      font-weight: normal;
      margin-left: 0;
  }

  div.body li.toctree-l4 {
      font-size: 93% ;
      list-style-type: circle;
      font-weight: normal;
      margin-left: 0;
  }

  div.body div.topic li.toctree-l1 {
      font-size: 100% ;
      font-weight: bold;
      background-color: transparent;
      margin-bottom: 0;
      margin-left: 1.5em;
      display:inline;
  }

  div.body div.topic p {
      font-size: 90% ;
      margin: 0.4ex;
  }

  div.body div.topic p.topic-title {
      display:inline;
      font-size: 100% ;
      margin-bottom: 0;
  }
</style><div class="section" id="welcome-to-scikit-learn">
<h1>Welcome to scikit-learn<a class="headerlink" href="#welcome-to-scikit-learn" title="Permalink to this headline">¶</a></h1>
<div class="line-block">
<div class="line"><br /></div>
</div>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="install.html">Installing scikit-learn</a><ul>
<li class="toctree-l2"><a class="reference internal" href="install.html#installing-the-latest-release">Installing the latest release</a></li>
<li class="toctree-l2"><a class="reference internal" href="install.html#third-party-distributions-of-scikit-learn">Third party distributions of scikit-learn</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="faq.html">Frequently Asked Questions</a><ul>
<li class="toctree-l2"><a class="reference internal" href="faq.html#what-is-the-project-name-a-lot-of-people-get-it-wrong">What is the project name (a lot of people get it wrong)?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-do-you-pronounce-the-project-name">How do you pronounce the project name?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why-scikit">Why scikit?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-can-i-contribute-to-scikit-learn">How can I contribute to scikit-learn?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#what-s-the-best-way-to-get-help-on-scikit-learn-usage">What’s the best way to get help on scikit-learn usage?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-should-i-save-export-or-deploy-estimators-for-production">How should I save, export or deploy estimators for production?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-can-i-create-a-bunch-object">How can I create a bunch object?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-can-i-load-my-own-datasets-into-a-format-usable-by-scikit-learn">How can I load my own datasets into a format usable by scikit-learn?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#what-are-the-inclusion-criteria-for-new-algorithms">What are the inclusion criteria for new algorithms ?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why-are-you-so-selective-on-what-algorithms-you-include-in-scikit-learn">Why are you so selective on what algorithms you include in scikit-learn?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why-did-you-remove-hmms-from-scikit-learn">Why did you remove HMMs from scikit-learn?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#will-you-add-graphical-models-or-sequence-prediction-to-scikit-learn">Will you add graphical models or sequence prediction to scikit-learn?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#will-you-add-gpu-support">Will you add GPU support?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#do-you-support-pypy">Do you support PyPy?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-do-i-deal-with-string-data-or-trees-graphs">How do I deal with string data (or trees, graphs…)?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why-do-i-sometime-get-a-crash-freeze-with-n-jobs-1-under-osx-or-linux">Why do I sometime get a crash/freeze with n_jobs &gt; 1 under OSX or Linux?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why-does-my-job-use-more-cores-than-specified-with-n-jobs">Why does my job use more cores than specified with n_jobs?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why-is-there-no-support-for-deep-or-reinforcement-learning-will-there-be-support-for-deep-or-reinforcement-learning-in-scikit-learn">Why is there no support for deep or reinforcement learning / Will there be support for deep or reinforcement learning in scikit-learn?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why-is-my-pull-request-not-getting-any-attention">Why is my pull request not getting any attention?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#how-do-i-set-a-random-state-for-an-entire-execution">How do I set a <code class="docutils literal notranslate"><span class="pre">random_state</span></code> for an entire execution?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why-do-categorical-variables-need-preprocessing-in-scikit-learn-compared-to-other-tools">Why do categorical variables need preprocessing in scikit-learn, compared to other tools?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#why-does-scikit-learn-not-directly-work-with-for-example-pandas-dataframe">Why does Scikit-learn not directly work with, for example, pandas.DataFrame?</a></li>
<li class="toctree-l2"><a class="reference internal" href="faq.html#do-you-plan-to-implement-transform-for-target-y-in-a-pipeline">Do you plan to implement transform for target y in a pipeline?</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="support.html">Support</a><ul>
<li class="toctree-l2"><a class="reference internal" href="support.html#mailing-list">Mailing List</a></li>
<li class="toctree-l2"><a class="reference internal" href="support.html#user-questions">User questions</a></li>
<li class="toctree-l2"><a class="reference internal" href="support.html#bug-tracker">Bug tracker</a></li>
<li class="toctree-l2"><a class="reference internal" href="support.html#irc">IRC</a></li>
<li class="toctree-l2"><a class="reference internal" href="support.html#documentation-resources">Documentation resources</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="related_projects.html">Related Projects</a><ul>
<li class="toctree-l2"><a class="reference internal" href="related_projects.html#interoperability-and-framework-enhancements">Interoperability and framework enhancements</a></li>
<li class="toctree-l2"><a class="reference internal" href="related_projects.html#other-estimators-and-tasks">Other estimators and tasks</a></li>
<li class="toctree-l2"><a class="reference internal" href="related_projects.html#statistical-learning-with-python">Statistical learning with Python</a></li>
<li class="toctree-l2"><a class="reference internal" href="related_projects.html#snippets-and-tidbits">Snippets and tidbits</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="about.html">About us</a><ul>
<li class="toctree-l2"><a class="reference internal" href="about.html#history">History</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#governance">Governance</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#authors">Authors</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#emeritus-core-developers">Emeritus Core Developers</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#citing-scikit-learn">Citing scikit-learn</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#artwork">Artwork</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#funding">Funding</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#sprints">Sprints</a></li>
<li class="toctree-l2"><a class="reference internal" href="about.html#infrastructure-support">Infrastructure support</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="testimonials/testimonials.html">Who is using scikit-learn?</a><ul>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id1">J.P.Morgan</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id2">Spotify</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id3">Inria</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id4">betaworks</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id5">Hugging Face</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id6">Evernote</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id7">Télécom ParisTech</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id8">Booking.com</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id9">AWeber</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id10">Yhat</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id11">Rangespan</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id12">Birchbox</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id13">Bestofmedia Group</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id14">Change.org</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id15">PHIMECA Engineering</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id16">HowAboutWe</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id17">PeerIndex</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id18">DataRobot</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id19">OkCupid</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id20">Lovely</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id21">Data Publica</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id22">Machinalis</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id23">solido</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id24">INFONEA</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id25">Dataiku</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id26">Otto Group</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id27">Zopa</a></li>
<li class="toctree-l2"><a class="reference internal" href="testimonials/testimonials.html#id28">MARS</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="whats_new.html">Release History</a><ul>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.22.html">Version 0.22</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.21.html">Version 0.21.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.21.html#version-0-21-2">Version 0.21.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.21.html#version-0-21-1">Version 0.21.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.21.html#version-0-21-0">Version 0.21.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.20.html">Version 0.20.4</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.20.html#version-0-20-3">Version 0.20.3</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.20.html#version-0-20-2">Version 0.20.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.20.html#version-0-20-1">Version 0.20.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.20.html#version-0-20-0">Version 0.20.0</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.19.html">Version 0.19.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.19.html#version-0-19-1">Version 0.19.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.19.html#version-0-19">Version 0.19</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.18.html">Version 0.18.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.18.html#version-0-18-1">Version 0.18.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.18.html#version-0-18">Version 0.18</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.17.html">Version 0.17.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.17.html#version-0-17">Version 0.17</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.16.html">Version 0.16.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.16.html#version-0-16">Version 0.16</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.15.html">Version 0.15.2</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.15.html#version-0-15-1">Version 0.15.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.15.html#version-0-15">Version 0.15</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.14.html">Version 0.14</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.13.html">Version 0.13.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/v0.13.html#version-0-13">Version 0.13</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html">Version 0.12.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#version-0-12">Version 0.12</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#version-0-11">Version 0.11</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#version-0-10">Version 0.10</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#version-0-9">Version 0.9</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#version-0-8">Version 0.8</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#version-0-7">Version 0.7</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#version-0-6">Version 0.6</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#version-0-5">Version 0.5</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#version-0-4">Version 0.4</a></li>
<li class="toctree-l2"><a class="reference internal" href="whats_new/older_versions.html#earlier-versions">Earlier versions</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="roadmap.html">Roadmap</a><ul>
<li class="toctree-l2"><a class="reference internal" href="roadmap.html#purpose-of-this-document">Purpose of this document</a></li>
<li class="toctree-l2"><a class="reference internal" href="roadmap.html#statement-of-purpose-scikit-learn-in-2018">Statement of purpose: Scikit-learn in 2018</a></li>
<li class="toctree-l2"><a class="reference internal" href="roadmap.html#architectural-general-goals">Architectural / general goals</a></li>
<li class="toctree-l2"><a class="reference internal" href="roadmap.html#subpackage-specific-goals">Subpackage-specific goals</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="governance.html">Scikit-learn governance and decision-making</a><ul>
<li class="toctree-l2"><a class="reference internal" href="governance.html#roles-and-responsibilities">Roles And Responsibilities</a></li>
<li class="toctree-l2"><a class="reference internal" href="governance.html#decision-making-process">Decision Making Process</a></li>
<li class="toctree-l2"><a class="reference internal" href="governance.html#enhancement-proposals-sleps">Enhancement proposals (SLEPs)</a></li>
</ul>
</li>
</ul>
</div>
<div class="line-block">
<div class="line"><br /></div>
</div>
</div>


      </div>
    <div class="container">
      <footer class="sk-content-footer">
            &copy; 2007 - 2019, scikit-learn developers (BSD License).
          <a href="_sources/preface.rst.txt" rel="nofollow">Show this page source</a>
      </footer>
    </div>
  </div>
</div>
<script src="_static/js/vendor/bootstrap.min.js"></script>

<script>
    window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
    ga('create', 'UA-22606712-2', 'auto');
    ga('set', 'anonymizeIp', true);
    ga('send', 'pageview');
</script>
<script async src='https://www.google-analytics.com/analytics.js'></script>


<script>
$(document).ready(function() {
    /* Add a [>>>] button on the top-right corner of code samples to hide
     * the >>> and ... prompts and the output and thus make the code
     * copyable. */
    var div = $('.highlight-python .highlight,' +
                '.highlight-python3 .highlight,' +
                '.highlight-pycon .highlight,' +
		'.highlight-default .highlight')
    var pre = div.find('pre');

    // get the styles from the current theme
    pre.parent().parent().css('position', 'relative');
    var hide_text = 'Hide prompts and outputs';
    var show_text = 'Show prompts and outputs';

    // create and add the button to all the code blocks that contain >>>
    div.each(function(index) {
        var jthis = $(this);
        if (jthis.find('.gp').length > 0) {
            var button = $('<span class="copybutton">&gt;&gt;&gt;</span>');
            button.attr('title', hide_text);
            button.data('hidden', 'false');
            jthis.prepend(button);
        }
        // tracebacks (.gt) contain bare text elements that need to be
        // wrapped in a span to work with .nextUntil() (see later)
        jthis.find('pre:has(.gt)').contents().filter(function() {
            return ((this.nodeType == 3) && (this.data.trim().length > 0));
        }).wrap('<span>');
    });

    // define the behavior of the button when it's clicked
    $('.copybutton').click(function(e){
        e.preventDefault();
        var button = $(this);
        if (button.data('hidden') === 'false') {
            // hide the code output
            button.parent().find('.go, .gp, .gt').hide();
            button.next('pre').find('.gt').nextUntil('.gp, .go').css('visibility', 'hidden');
            button.css('text-decoration', 'line-through');
            button.attr('title', show_text);
            button.data('hidden', 'true');
        } else {
            // show the code output
            button.parent().find('.go, .gp, .gt').show();
            button.next('pre').find('.gt').nextUntil('.gp, .go').css('visibility', 'visible');
            button.css('text-decoration', 'none');
            button.attr('title', hide_text);
            button.data('hidden', 'false');
        }
    });

	/*** Add permalink buttons next to glossary terms ***/
	$('dl.glossary > dt[id]').append(function() {
		return ('<a class="headerlink" href="#' +
			    this.getAttribute('id') +
			    '" title="Permalink to this term">¶</a>');
	});
  /*** Hide navbar when scrolling down ***/
  // Returns true when headerlink target matches hash in url
  (function() {
    hashTargetOnTop = function() {
        var hash = window.location.hash;
        if ( hash.length < 2 ) { return false; }

        var target = document.getElementById( hash.slice(1) );
        if ( target === null ) { return false; }

        var top = target.getBoundingClientRect().top;
        return (top < 2) && (top > -2);
    };

    // Hide navbar on load if hash target is on top
    var navBar = document.getElementById("navbar");
    var navBarToggler = document.getElementById("sk-navbar-toggler");
    var navBarHeightHidden = "-" + navBar.getBoundingClientRect().height + "px";
    var $window = $(window);

    hideNavBar = function() {
        navBar.style.top = navBarHeightHidden;
    };

    showNavBar = function() {
        navBar.style.top = "0";
    }

    if (hashTargetOnTop()) {
        hideNavBar()
    }

    var prevScrollpos = window.pageYOffset;
    hideOnScroll = function(lastScrollTop) {
        if (($window.width() < 768) && (navBarToggler.getAttribute("aria-expanded") === 'true')) {
            return;
        }
        if (lastScrollTop > 2 && (prevScrollpos <= lastScrollTop) || hashTargetOnTop()){
            hideNavBar()
        } else {
            showNavBar()
        }
        prevScrollpos = lastScrollTop;
    };

    /*** high preformance scroll event listener***/
    var raf = window.requestAnimationFrame ||
        window.webkitRequestAnimationFrame ||
        window.mozRequestAnimationFrame ||
        window.msRequestAnimationFrame ||
        window.oRequestAnimationFrame;
    var lastScrollTop = $window.scrollTop();

    if (raf) {
        loop();
    }

    function loop() {
        var scrollTop = $window.scrollTop();
        if (lastScrollTop === scrollTop) {
            raf(loop);
            return;
        } else {
            lastScrollTop = scrollTop;
            hideOnScroll(lastScrollTop);
            raf(loop);
        }
    }
  })();
});

</script>
    
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js"></script>
    
</body>
</html>